home *** CD-ROM | disk | FTP | other *** search
/ 500 MB Nyheder Direkte fra Internet 9 / 500 MB nyheder direkte fra internet CD 9.iso / start / install / cubic14 / cp.doc < prev    next >
Text File  |  1995-07-08  |  38KB  |  1,014 lines

  1.        
  2.        ▄▄▄▄▄▄▄▄   ▄▄▄    ▄▄▄   ▄▄▄▄▄▄▄▄    ▄▄▄▄▄▄▄▄    ▄▄▄▄▄▄▄▄
  3.      ▄▀        █ █   █  █   █ █        ▀▄ █        █ ▄▀        █
  4.      █  ▄▀▀▀▀▀▀  █   █  █   █ █  ▄▀▀▀▄  █  ▀▀▄  ▄▀▀  █  ▄▀▀▀▀▀▀
  5.      █  █        █   █  █   █ █   ▀▀▀ ▄▀     █  █    █  █
  6.      █  █        █   █  █   █ █   ▄▄▄ ▀▄     █  █    █  █
  7.      █  ▀▄▄▄▄▄▄  █   ▀▄▄▀   █ █  ▀▄▄▄▀  █  ▄▄▀  ▀▄▄  █  ▀▄▄▄▄▄▄
  8.      ▀▄        █ ▀▄        ▄▀ █        ▄▀ █        █ ▀▄        █
  9.        ▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀
  10.  
  11.                                ·P·L·A·Y·E·R·
  12.  
  13.                                    v 1.4
  14.  
  15.                              "simply the best!"
  16.  
  17.  
  18.    Table of contents
  19.    ==================
  20.    1......................................Introduction
  21.    
  22.    2......................................Using Cubic Player
  23.      2.1..................................General Keys
  24.      2.2..................................Modes and Related Keys
  25.      2.3..................................File Selector
  26.      2.4..................................Command Line Options
  27.  
  28.    3......................................Special Features
  29.      3.1..................................Surrround Sound
  30.      3.2..................................Midi Usage
  31.      3.3..................................Cubic Player and WIN'95 / OS/2
  32.      3.4..................................Intelligent Memory Multiplying (IMM)
  33.      3.5..................................Coprocessor
  34.      3.6..................................Double GUS Feature
  35.  
  36.    4......................................Notes, Bugs etc.
  37.  
  38.    5......................................Information on Cubic Player
  39.  
  40.    6......................................Greets, Credits
  41.      6.1..................................Adresses
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49. =============================================================================
  50.  
  51.        Attention ! Read the following BEFORE using Cubic Player.
  52.     
  53. =============================================================================        
  54.  
  55.     This material  is  not  freeware.  You  are  allowed to 
  56.     copy it  without  restrictions for non-commercial  use.
  57.     No payment  of any kind may be charged for this product 
  58.     or  any combination of products  or services  including 
  59.     this  product  without our  authorization  and official 
  60.     written  license.  Commercial use,  especially the 
  61.     industrial manufacturing on any  data storage media and 
  62.     their  distribution  without  the expressed  permission 
  63.     of  the producer, is strictly prohibited.  This program 
  64.     or the data files contained therein may  not be altered 
  65.     or modified without the permission of the author.
  66.     You  take full responsibility for the operation of this
  67.     software and any consequences thereof.  We the creators
  68.     cannot accept liability for damages or failures arising 
  69.     from the use of this software.
  70.  
  71. =============================================================================
  72.  
  73.    1: Introduction
  74.    ================
  75.  
  76.       Cubic Player (CP) is a music player which plays a variety of
  77.       sound formats on several sound cards.
  78.       The player supports the following sound cards:
  79.        -Gravis UltraSound
  80.        -SoundBlaster 1.x / 2.x / Pro / 16 & compatibles
  81.        -WSS compatible cards / UltraSound MAX / UltraSound DaughterBoard
  82.        -Pro Audio Spectrum series
  83.        -Quiet Player =)
  84.       and the following music formats:
  85.        MOD/NST/WOW, XM, S3M, DMF, MTM, ULT, 669, OKT, PTM and MIDI.
  86.       If you encounter any problems with this product NOT mentioned
  87.       in the text, feel free to contact us. (adresses listed below).
  88.  
  89.       And in case you wanted to run the player under Microsoft Windows 3.x
  90.       we'll tell you RIGHT HERE that this is NOT possible!
  91.       It seems to work ok with WINDOWS '95. (not tested by us)
  92.       This player does support OS/2 v3. See section 3.3 on this.
  93.  
  94.  
  95.  
  96.    2: Using Cubic Player
  97.    ======================
  98.  
  99.       Take your time to read this chapter, or you'll miss some of
  100.       the advanced options of Cubic Player...
  101.  
  102.       You can simply start the player without command line options [and
  103.       filenames], the player will try to detect your sound device and start
  104.       playing the specified files.
  105.       If you have not specified any files, you will enter the fileselector
  106.       and can select a list of files of your choice.
  107.       After that you'll most probably find yourself in the instruments
  108.       screen.
  109.  
  110.  
  111.    2.1: General Keys:
  112.    -------------------
  113.  
  114.       these keys are valid throughout the player. (not in the fileselector)
  115.  
  116.       2.1.1: Very very general keys...
  117.       ---------------------------------
  118.  
  119.        F1 / ? / H   : Online HELP
  120.               scroll with pgup and pgdn or ctrl-pgup/dn.
  121.               if the Help window :) is too small press z
  122.  
  123.        return       : next module
  124.  
  125.        p            : II / =>   (pause and play)  have fun... ;)
  126.        ctrl-p       : this is a faster version of pause...
  127.            alt-p        : idle mode. stop screen output and wait for key!
  128.                             nice thing for multitaskers.
  129.  
  130.        d            : advanced dos-shell!
  131.        ctrl-d       : less advaned dos-shell... (no top line patching)
  132.  
  133.        f            : fileselector (see. 2.3 for usage)
  134.  
  135.        z            : toggle vertical screen size (25/50 lines)
  136.        alt-z        : toggle horizontal screen size (80/132 rows)
  137.        ctrl-z       : toggle vertical screen size (25/30 lines)
  138.  
  139.        esc esc      : the taboo keys... :)
  140.                quite useless feature, I think
  141.  
  142.  
  143.       2.1.2: Module Specific Keys
  144.       ----------------------------
  145.  
  146.     with these keys you can walk around in the song,
  147.     you have to press ctrl for all of them.
  148.  
  149.        ctrl-right   : go to next pattern
  150.        ctrl-left    : go to previous pattern
  151.        ctrl-up      : go 8 rows up in current pattern (rewind)
  152.        ctrl-down    : go 8 rows down in current pattern (forward)
  153.        ctrl-home    : restart the current song
  154.  
  155.  
  156.       2.1.3: Channel Options
  157.       -----------------------
  158.     The channels are displayed in all textmodes. In the graphic modes
  159.     there is a small box with the channel to let you know which channels
  160.     are active at the moment and which channel is selected.
  161.     There are 3 channel display modes toggled by c:
  162.       -no display: does exactly what it implies.
  163.       -small channels: shows from left to right:
  164.         instrument number, note, volume, effect and volume bars
  165.       -big channels: shows from left to right:
  166.         instrument name, note, note effect, volume, volume effect,
  167.         panning, panning effect, effect (written) and volume bars
  168.  
  169.     If a note is struck it will be cyan for the current row.
  170.     The note, volume and panning effects are described in 2.2.2.2.2
  171.  
  172.     2.1.3.1: Channel Keys
  173.     ----------------------
  174.  
  175.        c            : changes the size of the channel display
  176.  
  177.        left / right : go to previous / next channel
  178.        up   / down  : go to prev / next channel with wrap-around
  179.        q            : toggle currently selected channel
  180.        s            : solo channel
  181.        1 2 3 .. 0   : goto and toggle channel 1 .. 10
  182.        ctrl-1 .. 0  : goto and solo channel   1 .. 10
  183.        ctrl-q/ctrl-s: turn on all channels
  184.  
  185.  
  186.       2.1.4: Volume Options
  187.       ----------------------
  188.  
  189.     these keys are for volume, stereo fx, speed etc.
  190.     they are arranged like the 2nd line on the screen for easy usage.
  191.  
  192.        F2 F3        : dec/inc the master volume
  193.         + -         : this lets you adjust the m.vol. more precisely
  194.  
  195.        ctrl-F2/F3   : dec/inc the amplification level,
  196.               this takes a little bit of time on sb, so be careful
  197.               (We won't take responsibility for your ears..)
  198.  
  199.        F4           : toggle surround (only stereo and Sound Blaster)
  200.               flips one channel, makes the sound surround you...
  201.               a nice options for headphones or if you have
  202.               4 speakers installed, (you can find a description
  203.               of how to set them up below) and even if you don't.
  204.               You will only hear it if some of the output is
  205.               equal on both channels... (combine it with panning)
  206.               does not work on a GUS of course!
  207.  
  208.        F5 F6        : slide panning. panning shifts the sound to
  209.               the middle or exchanges the channels with each other
  210.  
  211.               if you use headphones, set the panning to somewhere
  212.               in between middle and full. it will sound much much
  213.               much much better!!!
  214.         , .         : finer panning
  215.  
  216.        F7 F8        : slide balance
  217.         / *         : fine balance
  218.  
  219.        F9  F10      : dec/inc playback speed (see ctrl-F12)
  220.        F11 F12      : dec/inc pitch (see ctrl-F12)
  221.  
  222.        ctrl-F12     : toggle speed and pitch lock.
  223.               if on, a change in speed also will affect the pitch
  224.                 and vice versa
  225.  
  226.        backspace    : toggle the amazing 32-bit-fast-fourier-interpolation
  227.               (SB only !)
  228.  
  229.        ct-backspace : change filter, pretty useless with high sampling
  230.               rates... 3 different filters with increasing effect
  231.               and 32-bit-fast-fourier-interpolation
  232.               (SB only again !)
  233.  
  234.        alt-F2       : save the current values for panning, balance,
  235.               amplification, filter/FFI, pitch etc.
  236.        alt-F3       : load previously saved values
  237.        alt-F4       : load manufactory default settings / reset
  238.  
  239.  
  240.  
  241.  
  242.    2.2: Modes and Related Keys
  243.    ----------------------------
  244.  
  245.       Note: all previously listed keys are still valid in all modes.
  246.  
  247.        h    ?   F1  : Help Mode (should be self-explanatory)
  248.        i            : Instrument Mode (2.2.1)
  249.        m            : View Song Message (MTM/DMF), keys like in help mode
  250.        t            : Pattern View (2.2.2)
  251.        a            : Text Mode Spectrum Analyser (2.2.3)
  252.        g            : Graphic Spectrum Analyer (2.2.4)
  253.        o            : Scopes (2.2.5)
  254.        n            : Note Dots (2.2.6)
  255.        w            : Würfel mode, höhö.. (see yourself)
  256.        x            : EXTENDED MODE... beat it!!!
  257.        e            : Echo Editor (2.2.7)
  258.  
  259.  
  260.       2.2.1: Instrument Mode   <i>
  261.       -----------------------------
  262.     The usual instrument display... a bit more comfortable than others!
  263.  
  264.        tab          : toggle between short and long instruments
  265.        pgup / pgdn  : scroll
  266.        ctrl-pgup/dn : scroll fast
  267.        home         : go home!
  268.        alt-i        : clear instrument used flags... wow!
  269.  
  270.  
  271.       2.2.2: Pattern View   <t>
  272.       --------------------------
  273.  
  274.     it's really simple:
  275.     colors indicate the type of effect:
  276.  
  277.     2.2.2.1: Global Effects
  278.     ------------------------
  279.        green   speed commands     (tempo, speed)
  280.        red     position commands  (break, goto, patloop, patdelay)
  281.        blue    global vol fx      (set glob vol, glob vol slide)
  282.  
  283.     2.2.2.2: Channel Effects
  284.     -------------------------
  285.        white   instrument effect  (set instrument, play note, etc.)
  286.        green   pitch effect       (porta, vibrato, arpeggio, etc.)
  287.        blue    volume effect      (set volume, volslide, tremolo, etc.)
  288.        purple  panning effect     (set panning, panning slide)
  289.        red     note effect        (cut note, delay note, etc.)
  290.  
  291.     the symbols/letters indicate the effect, the values are given in hex
  292.     volumes: 00-FF in contrast to volumes in most module formats (00-40)
  293.     panning: 00-FF from full left to full right
  294.     first instrument is 00 not 01.
  295.  
  296.     2.2.2.2.1: Global Effects
  297.     --------------------------
  298.        green   t??       tempo, the number of ticks per row
  299.            s??       speed, the number of ticks per time
  300.        red     down??    break pattern and start next one in row ??
  301.            right??   goto pattern
  302.            pl?       pattern loop: 0 set label, others: loop ? times
  303.            pd?       delay pattern for ?*tempo ticks
  304.        blue    v??       set global volume
  305.            up??      global volume slide up
  306.            down??    global volume slide down
  307.            updown00  continue last global volume slide
  308.  
  309.     2.2.2.2.2: channel effects
  310.     --------------------------
  311.        white   i??       set instrument
  312.            C-4...    play note C, octave 4
  313.            off       key off (XM only)
  314.            right??   set envelope position (XM only)
  315.        green   C-4...    set porta to note note         (porta to note)
  316.            up??      pitch slide up   00: cont      (porta up)
  317.            down??    pitch slide down 00: cont      (porta down)
  318.            +??       row pitch slide up             (finetune)
  319.            -??       row pitch slide down           (finetune)
  320.            note??    pitch slide to note 00: cont   (porta to note)
  321.            ~??       vibrato
  322.            ~right?   vibrato set speed
  323.            ~=?       vibrato set waveform
  324.            ≡??       arpeggio
  325.        blue    v??       set volume
  326.            up??      volume slide up
  327.            down??    volume slide down
  328.            +??       row volume slide up            (finevol)
  329.            -??       row volume slide down          (finevol)
  330.            ~??       tremolo
  331.            ~=?       set tremolo waveform
  332.            ⌐??       tremor, does anyone use it?
  333.        purple  p??       set panning
  334.            right??   panning slide right
  335.            left??    panning slide left
  336.            >face<    enable surroud sound for channel (see below)
  337.        red     d??       delay, delays anything, usually notes
  338.            !!??      retrigger
  339.            right??   sample offset
  340.            ^??       note cut
  341.  
  342.     2.2.2.3: Keys in Pattern View
  343.     ------------------------------
  344.  
  345.          space  : toggle auto / manual mode
  346.       ctrl-pgup/dn  : scroll instruments
  347.           home  : set optimum mode for current module
  348.  
  349.            auto mode:
  350.        pgup / pgdn  : change number of channels: 32,24,16,8,4
  351.            tab  : toggle mode (fx on/off etc)
  352.  
  353.          manual mode:
  354.        pgup / pgdn  : move through patterns
  355.        [shift]-tab  : change # of channels, mode
  356.  
  357.  
  358.       2.2.3: Text Mode Spectrum Analyser   <a>
  359.       -----------------------------------------
  360.     On faster computers the spectrum analyser can look a bit dirty.
  361.     This is because the player does not wait for a refresh when displaying.
  362.     A decay speed is not yet included.
  363.  
  364.        a / alt-F5   : toggle channel mode (all/current)
  365.       ctrl-pgup/dn  : scroll instruments
  366.        pgup / pgdn  : change visible frequency range
  367.        home         : set maximum freq to approximately 3000Hz
  368.        tab          : change colors
  369.  
  370.  
  371.       2.2.4: Graphic Spectrum Analyser   <g>
  372.       ---------------------------------------
  373.     That kind of stripes that are used in voice recognition...
  374.     Watch the vibratos!!! wow.. that's cool..
  375.       have a look at guitarsl.mod, armani.s3m and space.mod
  376.  
  377.        g / alt-F3   : toggle channel mode:
  378.                 - both output channels
  379.                 - mixed output channels
  380.                 - currently selected channel only
  381.        alt-g        : toggle between fast and fine mode
  382.        pgup / pgdn  : change visible frequency range
  383.        home         : set maximum frequency to approximately 3000 Hz
  384.        tab ctrl-tab : change scale / palette
  385.  
  386.        NEW: shift-g : The Big-GSA !!!! on amazing 1024x768 resolution
  387.               (we wish you a Pentium for this mode :-)
  388.  
  389.  
  390.       2.2.5: Scopes   <o>
  391.       --------------------
  392.  
  393.     Just simple oscilloscopes for all or one channel
  394.     The background piccy needs an extra 250k of memory, if you don't have
  395.     that much you can disable the picture with a command line option.
  396.  
  397.        o alt-F2     : toggle mode (single/all channels)
  398.        alt-o        : toggle trigger, starts the output on a
  399.               polarity change
  400.        pgup / pgdn  : stretch scopes
  401.  
  402.  
  403.       2.2.6: Note Dots <n>
  404.       ---------------------
  405.  
  406.     They really look cool, because they use the real frequency and
  407.     the real volume...
  408.  
  409.        n            : toggle between dots, bars, stereo cones and
  410.               stereo dots !
  411.        pgup/dn      : slide range
  412.        ctrl-pgup/dn : slide scale
  413.  
  414.  
  415.       2.2.7: Echo Editor <e>
  416.       -----------------------
  417.  
  418.     Yeah, now it's here. The ultimate Echo Online Editor you have
  419.     long waitet for. Create your own Echos with 8 or 16bit quality and
  420.     up to 8 different generators. Or simply pick one of the predefined
  421.     Echos and enjoy your tunes with the glorious sound of Cathedral II.
  422.     (Echos are only available on SB and GUS MAX/WSS)
  423.  
  424.     Selector Keys
  425.     --------------
  426.  
  427.        enter        : use the currently selected echo
  428.  
  429.        ctrl-up/down : move the echo in list
  430.        ctrl-del     : delete echo from list
  431.        ctrl-ins     : store the echo from the editor at the current
  432.               position and save the echo list.
  433.  
  434.        tab          : jump to editor copying the current echo
  435.  
  436.        esc          : leave echo selector / editor returning to cp
  437.  
  438.     Editor Keys / Usage
  439.     --------------------
  440.  
  441.       At first you have to select how many Operators your echo should
  442.       have in the field OPNUM. Up to 8 Operators are possible.
  443.       Then you should define the maximum delay in 0.1 ms. This will have
  444.       an effect on the memory requierements of the echo. Then the general
  445.       feedback FB should be set. The higher the value the more often the
  446.       echo signal is passed in the generator (the louder and stronger the
  447.       echo will appear).
  448.       Now type in the delay of the Operators in 0.1 ms and their feedback
  449.       volume (volumes can be negative, that means the samples will be
  450.       player reversed).
  451.       At last you can choose a name and 8 or 16bit mixing (of course
  452.       16bit mixing takes more resources, but especially with modules
  453.       above 16 channels or MIDIs 8bit mixing does not work anymore,
  454.       you have to choose 16bit mixing (this has technical reasons))
  455.       You can also slide the values by pressing pgup/dn
  456.  
  457.       If you have created interesting and new echos or any comments
  458.       the the echo function feel free to contact us!
  459.  
  460.       btw: chorus will not often have much effect on the output...
  461.  
  462.  
  463.  
  464.    2.3: FileSelector   <f> <ins>
  465.    ------------------------------
  466.       An easy way to search and play your favourite modules
  467.       now in version ][. now caches modules... reads from zips...
  468.       reads, edits and writes module information files
  469.  
  470.       At first it scans the current directory for modules (files with
  471.       the extension .MOD .S3M .XM, .MID...) and lets you select
  472.       files. While you do this, it scans the modules for the titles
  473.       and number of voices. This can be very slow on disks and CDs and you
  474.       can stop it by pressing ctrl-backspace. If you've found a nice module
  475.       you can either play it now by pressing return or put it in the
  476.       playlist with -> or ins. There is also a quickfind feature: Simply
  477.       type the name of the module and the fileselector will go to the
  478.       file. (You don't need to complete the name or type it correctly,
  479.       it will take the name that is most similar to the typed name)
  480.       When you have finished the playlist, hit esc. Remember: return plays
  481.       the currently selected module.
  482.  
  483.  
  484.       2.3.1: Keys for Fileselector
  485.  
  486.        up, down,
  487.        pgup, pgdn,
  488.        home, end    : the usual stuff...
  489.  
  490.        abc123...    : quickfind
  491.  
  492.        return       : play selected module RIGHT NOW!
  493.        esc          : leave fileselector, don't interrupt current mod
  494.  
  495.        ins    ->    : add mod to list      (both windows)
  496.        del    <-    : remove mod from list (both windows)
  497.  
  498.        ctrl-left,
  499.        ctrl-ins     : add all mod in current directory to list
  500.        ctrl-right,
  501.        ctrl-del     : clear playlist
  502.  
  503.        tab          : toggle "window"
  504.        shift-tab    : toggle editor (pgup/dn in editor for move in list)
  505.        alt-tab      : toggle view mode
  506.  
  507.        ctrl-up, down: move mod in playlist
  508.        pgup, pgdn,  :  (my god, why do i do this?? no one will ever use
  509.        home, end    :   this feature...)
  510.  
  511.        ctrl-backspc : stop reading module info
  512.        alt-s        : if ctrl-backspace does not work
  513.  
  514.        alt-z        : toggle 80*25 / 132*60 lines mode
  515.        alt-c        : configuration menu (session only, not permanent!)
  516.        alt-a        : write module information file for dir/list.
  517.        alt-w        : write module information file for sel. mod.
  518.        alt-i        : toggle view mode
  519.        alt-k        : zap this file!
  520.  
  521.  
  522.  
  523.    2.4: Command Line
  524.    ------------------
  525.  
  526.     At the command line you can specify the modules you wish to play.
  527.     This works very much like the dos DIR command, e.g. type
  528.       cp d:\mods\guitarsl
  529.       cp \mods
  530.       cp \mods\.xm
  531.       cp .
  532.       cp c:
  533.  
  534.     You can also give a playlist: cp @d:\mods\favorite.lst
  535.     (playlists can be nested, though this feature has not yet
  536.      been tested extensively)
  537.     NOTE: This feature is not available at the moment due to complete
  538.           rebuilt of the fileselector and leck of time.
  539.  
  540.     if you have not specified any modules or none of them could be found
  541.     cp will start up with the file selector.
  542.  
  543.  
  544.       2.4.1: Usage of Command Line Options etc.
  545.       ------------------------------------------
  546.  
  547.     The command line options are arranged in groups:
  548.        -h[n]:  view help screen #n
  549.        -c:  2.4.2: Sound Device Specific Switches
  550.        -v:  2.4.3: Volume Specific Switches
  551.        -w:  2.4.4: Screen Specific Switches
  552.        -l:  2.4.5: Playlist Specific Switches
  553.        -m:  2.4.6: Midi Switches
  554.  
  555.     You can use switches everywhere in the command line, you can
  556.     also set default values with the environment variables CP in the
  557.     file CP.CFG in CP.EXE's path.
  558.     The format is always the same, all switches begin with - or /
  559.     Switches of the same group can be put together separated by a ,
  560.     (no whitespaces in between!):
  561.       -cb -cc0 == -cb,c0
  562.  
  563.       -h            : This is a pretty good feature if you don't know
  564.       -?            : all the switches by heart
  565.  
  566.       2.4.2: Sound Device Specific Switches
  567.       --------------------------------------
  568.       -c...
  569.         c??         : sounddevice
  570.                 0  : quiet
  571.                 1  : sb 1.x
  572.                 2  : sb 2.x
  573.                 3  : sbpro
  574.                 4  : sb 16 (asp)
  575.                 10 : gus
  576.                 20 : Windows Sound System WSS,
  577.                  GUS + 16bit daughterboard
  578.                 21 : GUS MAC CODEC
  579.               ATTENTION ! ALL GUS IRQs MUST BE BELOW 8
  580.         p???        : port in hex
  581.         z???        : secondary port
  582.         i??         : irq in dec
  583.         j??         : secondary irq
  584.         d?          : dma
  585.         e?          : secondary dma
  586.         r?????      : sampling rate in Hz or kHz
  587.         q?????      : sampling rate for 32 channels
  588.         b[-]        : bypass mode [off], bypasses the detect/check
  589.               routines, make sure to set all parameters correctly!
  590.         m           : mono
  591.         s           : stereo
  592.         8           : eight bit
  593.         16          : sixteen bit
  594.         l[+]        : small buffer, if you think the sound output is too
  595.               much behind. this could cause trouble on slower
  596.               systems, mods with many channels or if echo is
  597.               enabled
  598.         g[+]        : slow gus upload: if dma does not work.
  599.         f           : disable coprocessor usage
  600.  
  601.  
  602.       2.4.3: Volume Specific Switches
  603.       --------------------------------
  604.       -v...
  605.         v??       : master volume: 0%..100%, default 100%
  606.         a???      : amplify: 0%..400%, default 100%
  607.         p???      : panning: -100%..+100%, default 100%
  608.         b???      : balance: -100%..+100%, default 0%
  609.         s[-]      : surround sound [off]
  610.         f?        : lowpass filter 0..4 -
  611.                 0 : none
  612.                 1 : very soft
  613.                 2 : soft
  614.                 3 : middle
  615.                 4 : effective
  616.                 5 : 32-bit Fast-Fake-Interpolation
  617.                 6 : 48-bit Adaptive-Oversampling-Interpolation
  618.                 7 : 64-bit Full-Oversampling-Interpolation
  619.  
  620.       2.4.4: Screen Specific Switches
  621.       --------------------------------
  622.       -w...
  623.         c[+/-]      : channels: short, +:long, -:none
  624.         zxx         : text mode: 0: 80x25, 1: 80x30, 2: 80x50, 3: 80x60
  625.                      4:132x25, 5:132x30, 6:132x50, 7:132x60
  626.         cxx         : channel display type xx:
  627.               0:none, 1:short, 2:long, 3:side
  628.         ixx         : instrument display type xx:
  629.               0:none, 1:short, 2:long, 3:side
  630.         a[-]        : turn spectrum analyser on [off]
  631.         t[-]        : turn pattern view on [off]
  632.         x           : display very much! (extended mode)
  633.         sx          : startup screen x: o/g/i/a/t/w  (see 2.2)
  634.         p[+]        : don't [do] load scope background picture
  635.               [requires 200k mem]
  636.  
  637.       2.4.5: Fileselector Switches
  638.       ----------------------------------
  639.       -f...
  640.         l[+]        : don't [do] loop modules
  641.         o[-]        : don't [do] scramble playlist order
  642.         r[+]        : don't [do] remove mods from list if played
  643.         a[+]        : don't [do] scan archives
  644.         n[+]        : don't [do] scan module names
  645.         b[+]        : don't [do] scan in (ZIP) archives
  646.         i[+]        : don't [do] scan module information files
  647.         w[+]        : don't [do] write module information cache files
  648.         e[+]        : don't [do] show module information window
  649.         c[+]        : don't [do] use different colors for different types
  650.         z??         : screen size (see -wz)
  651.         pPATH       : startup path in the fileselector (also affects
  652.                          command line modules)
  653.  
  654.  
  655.       2.4.6: Midi Switches
  656.       ---------------------
  657.       -m...
  658.         cnn         : use nn channels for midi output
  659.         ppath       : path of the gus-patches
  660.  
  661.  
  662.  
  663.  
  664.  
  665.    3: Special Features
  666.    ====================
  667.  
  668.    3.1: Surround Sound
  669.    --------------------
  670.  
  671.    This sounds pretty nice if you have a stereo non-wavetable soundcard.
  672.    Just buy 1,2 or 3 additional speakers, connect them as showed below
  673.    and press F5 twice and F4 in Cubic Player.
  674.  
  675.                Stereo
  676.         + L -           - R +
  677.            +-+ +-+         +-+ +-+
  678.            +-+ +-+         +-+ +-+
  679.         I   I           I   I
  680.         I   I           I   I
  681.        +----+   +-----+-----+   +-----+
  682.        I    I         I         I     I
  683.        I    I         I         I     I
  684.        I    I         -         I     I
  685.        I    I     M-Speaker     I     I
  686.        I    I         +         I     I
  687.        I    I         I         I     I
  688.        I    +   - ----+---- -   +     I
  689.        I  L-Speaker        R-Speaker  I
  690.        I                              I
  691.        I                              I
  692.        +---+  +-------------+  +------+
  693.            I  I             I  I
  694.            +  -             -  +
  695.          S1-Speaker      S2-Speaker
  696.  
  697.        Thanks to Micheal Erdmann for this diagram.
  698.        (we cannot be made liable for burning equipment, etc.)
  699.  
  700.  
  701.    3.2: Midi usage
  702.    ----------------
  703.  
  704.    You have to have the GUS patches for midi support. If you haven't got a
  705.    GUS you can find them on many BBSs, they usually come as "GUS-drivers"
  706.    and are about 5-6 disks big. GUS users can skip the following part.
  707.    (hey, don't mess around with the default.cfg, this can cause errors,
  708.     if you make changes to the default.cfg, that refuse to work with cp,
  709.     make a copy of the original one and call it cpmidi.cfg)
  710.    After installing them into any directory, add the following statement
  711.    to cp.cfg:  (if there is no cp.cfg yet, create it in the cp directory)
  712.  
  713.     -mpPATH    where PATH is the directory of your gus-patches.
  714.  
  715.    In midi mode, some options are disabled and some will look different.
  716.    (not all midi effects are processed at the moment, so if you've got
  717.    information on midis or the gus patches, contact us!)
  718.  
  719.  
  720.    3.3: Cubic Player and WIN'95 / OS/2
  721.    ------------------------------------
  722.      if you want to run cp in the background press alt-p to stop all
  723.      screen output and enter idle mode. press any key to continue.
  724.  
  725.  
  726.      Windows 95:
  727.      -----------
  728.  
  729.    Yes, Cubic Player works with Windows 95. You have to disable the
  730.    "windows detectable" options for the DOS-Task:
  731.      - click the start button
  732.      - open the program folder
  733.      - launch the MS-DOS prompt
  734.      - switch the DOS prompt to a window [alt-enter]
  735.      - click in the upper left corner of the DOS window
  736.      - select "properties"
  737.      - select "advanced"
  738.      - activate "prevent MS-DOS based programs from detecting windows"
  739.      ( - activate some other switch concerning ms-dos operation )
  740.      - close the DOS prompt and reopen it so changes can have effect
  741.      - now you can run CP under WIN'95 in a window (text mode 80x25 &
  742.     80x50 only) or in full screen [alt-enter] with all the modes.
  743.  
  744.     thanks fly out to David Márquez Hernández for description.
  745.  
  746.     we are not quite sure if cp will run satisfactory on all
  747.     configurations.
  748.  
  749.  
  750.      OS/2:
  751.      -----
  752.  
  753.    Yes, Cubic Player works with OS/2 v3. Simply create a Program-Object
  754.    from the Template-Folder. Select DOS-Fullscreen from the Session-Settings
  755.    (NO, it does NOT run in a window.) Make sure to put DOS4GW.EXE as the
  756.    executable and CP.EXE as parameter. Cubic Player should now work with the
  757.    standard DOS-Settings.
  758.    If your soundcard is not detected properly, specify it manually in your
  759.    cp.cfg (See section 2.4 on this).
  760.    Now you have the ONLY Multi-format player that works well with OS/2!
  761.    There may be a small clicks or interruptions during task-switching,
  762.    but hey, thats OS/2...!
  763.  
  764.    another thing... running CP with OS/2 may cause random disk writes... :]
  765.  
  766.  
  767.    3.4: Intelligent Memory Multiplying (IMM)
  768.    ------------------------------------------
  769.    What is Memory Multiplying? Well, that's exactly what it tells you. It
  770.    can increase the amount of GUS-memory when playing large modules or
  771.    MIDIs with many patches.
  772.    CUBIC-Player can make up to 8MB out of 1MB of GUS-Ram, so there
  773.    shouldn't be any problem with loading large modules.
  774.    IMM is enabled automatically when playing on a GUS and low of GUS-RAM.
  775.    There is no way of disabling it, because otherwise your modules wouldn't
  776.    be played correctly (there're just samples missing :-)
  777.    What it does? The first step is to look if any 16bit samples exist.
  778.    These are converted to 8bit samples, because the quality loss between
  779.    8 and 16bit is almost neglictable (If you only have ONE intrument at
  780.    moderate volume 8bit are enough, not for a complete audio track
  781.    such as on CD of course). If the samples now don't fit into GUS-RAM
  782.    CP tries to crunch the lowest sample. So your HiHats and other
  783.    instruments that requiere high sampling rates should survive the process
  784.    of crunching sample data.
  785.    Other GUS-Player just crunch EVERY sample, not CP. We test after every
  786.    attempt to crunch if the tune does now fit into your GUS.
  787.    You'll here the difference!
  788.  
  789.  
  790.    3.5: Use of Co-Processor
  791.    -------------------------
  792.    You can disable the use of your Co-Processor with the -cf+ switch.
  793.    [default setting is Co-Processor enabled]
  794.    Co-Processor is only used for Fast-Fourier-Calculations, that means
  795.    all modes where spectrum analyser appear (text and graphic modes).
  796.    Normally the integer calculations are faster (386-486). But we don't
  797.    know for fast Pentiums, because of their new Co-Processor unit. If you
  798.    are the lucky owner of a Pentium try for yourself.
  799.  
  800.  
  801.    3.6: Double UltraSound
  802.    ----------------------
  803.    CP can adress 2 UltraSounds at a time and output on 4 channels
  804.    There are 2 modes: 2D and 3D.
  805.    The speakers have to be set up as shown in the diagrams.
  806.  
  807.            GUS1                         GUS1
  808.        [L]------[R]                 [L]------[R]
  809.  
  810.             2D                           3D
  811.                                              [R] top
  812.        [L]------[R]                         /
  813.            GUS2                           / GUS2
  814.                                         /
  815.                                      [L] bottom
  816.  
  817.    CP will adress the first UltraSound as usual and the second one only
  818.    via its port. The amount of GUS memory will be the minimum of the 2
  819.    UltraSounds. You can the surround feature (F4) to make cp assign
  820.    the instruments to random points in space, or set the 3d-panning
  821.    by the Yyz command in XMs. This is a non standard command, and may be
  822.    changed in the future:
  823.             y=0:below, y=F:above, z=0:behind, z=F:in front
  824.    The 2 UltraSounds have to be properly inited before starting cp:
  825.     set ultrasnd=settings of GUS2
  826.     set ultra16=settings of GUS2 (if it has a DB or is GUSMAX)
  827.     ultrinit
  828.     set ultrasnd=settings of GUS1
  829.     set ultra16=settings of GUS1 (if it has a DB or is GUSMAX)
  830.     ultrinit
  831.    Then start cp with -cc11 [for 2D] or -cc12 [for 3D]
  832.                   and -czPPP [port of GUS2]
  833.  
  834.  
  835.  
  836.    4: Notes, bugs, etc.
  837.    =====================
  838.  
  839.    4.1: Notes on the Implementation of the Formats
  840.    ------------------------------------------------
  841.  
  842.      XM: -Older XMs do not load. (claustr2.xm, shelter.xm), because that
  843.       format is completely different and will not be supported.
  844.       (unless I get a description...) Rewrite them with ft2!
  845.       Does anyone know exactly how to handle the auto vibrato effect?
  846.          -Yyz is used for 3d-panning:
  847.             y=0:below, y=F:above, z=0:behind, z=F:in front
  848.     DMF: -some fx missing
  849.     OKT: -some fx missing
  850.     PTM: -some fx missing (note slide)
  851.  
  852.  
  853.    4.2: Known Bugs
  854.    ----------------
  855.  
  856.     - cp crashes on some systems (this bug occurred between 0.96 and 1.0)
  857.       it might work with a different setup (boot with F5), though this
  858.       can only be a temporary solution. please tell us (if it works with
  859.       a clean boot) which driver, or which combination of drives causes
  860.       cp to crash on which soundcard. Does it crash with WSS or PAS at all?
  861.       strange thing... sorry if it happens!
  862.     - midis are not played 100% correctly all the time..
  863.       (docs, docs, docs, please! (but not the standard ones))
  864.       (especially about the .PAT format (not the SDK one))
  865.     - the first-note-after-a-loop in no-loops-mode bug
  866.     - If you press the <pause> key, the player may stop playing.
  867.       We could remove this bug, but then there will be another bug...
  868.       some keystrokes will be missed... hmm, there sure is another way... :)
  869.     - my GUS does not work :-(
  870.       OK, we know, that's because CP can't handle IRQs greater than 7.
  871.       (Apparantly that's not our fault but DOS4GW's. The DOS Extender does
  872.        not pass IRQs above 7 from real mode correctly) As Every GUS owns a
  873.       second IRQ, that is normaly set to IRQ5 in 95% GUSes do work. If you
  874.       have set your second (or MIDI) GUS IRQ to above 7 CP will take 2 or
  875.       more seconds longer to load all the modules and will most probably
  876.       stop playing after a few seconds). You can solve this by changing your
  877.       SET ULTRASOUND=port,dma1,dma2,irq1,irq2 commmand in the autoexec.bat
  878.       to any free IRQ below 8.
  879.  
  880.  
  881.    4.3: Future Enhancements
  882.    -------------------------
  883.     - more formats (AMS at first)
  884.     - MPU 401
  885.     - [secret] :)
  886.  
  887.  
  888.  
  889.   5: Information on Cubic Player
  890.   ===============================
  891.  
  892.     The player was started somewhere in 1993, (was it?) using Borland C++ 3.1
  893.     and TASM 3.1, and was used in VEX-intro, which was presented at the
  894.     Assembly '94. That version was still quite buggy, but the bugs did not
  895.     appear in the VEX-tune... In late September '94 I got Watcom C++ v10 and
  896.     transformed the sources to Watcom's C++ implementaton. Then the player
  897.     was given a user interface, which was worked out in the following
  898.     nine months. The playback quality was also improved, so you now have
  899.     one of the best and fastest module players. The mixer is especially fast
  900.     (that's what my speed test program told me, a simple loop per time count
  901.     program, no tricks) with multi channel modules that use panning, faster
  902.     than any other players I know of.
  903.     This is quite astonishing, since less than 5% of the player was coded in
  904.     assembler, the rest in C/C++. (600k source in C++, 15k source in ASM,
  905.     10k assembler object code, the rest in C/C++, takes 15 min to compile ;)
  906.     Cubic Player uses Rational Systems' DOS4G DOS extender, so the player
  907.     can use all (or 16M at maximum) your extended / expanded memory.
  908.     well... currently we are having a kinda war with the coder, organizer
  909.     and sysops of another player... just for info... :)
  910.     (Huhu Nachhilfelehrer!!! huahua!)
  911.     [no time for more facts, David!]
  912.  
  913.  
  914.  
  915.    6: Greets, Credits
  916.    ===================
  917.  
  918.       thanks go to:
  919.       --------------
  920.     Glenn & Marc Moore / Sound Solutions
  921.     Jens Uwe Rumstich / Green Apple
  922.     Scholar / $EEN
  923.     Matthias Beilicke
  924.     Iron Eagle / TC
  925.     Abyss / FC
  926.     SS.C
  927.  
  928.  
  929.       for ß-testing:
  930.       ---------------
  931.     the Sodomist
  932.     Scholar / $EEN
  933.     Green Apple
  934.     Zomb
  935.     Shadow Dancer / $EEN
  936.     Encounter
  937.     the Frontier
  938.  
  939.  
  940.       greets:
  941.       --------
  942.     THE COEXiSTENCE
  943.     Green Apple
  944.     Future Crew
  945.     Legend Design
  946.     Cascada
  947.     $EEN
  948.     K.L.F.
  949.     Complex
  950.  
  951.  
  952.     Libertine / TC
  953.     Jinx! / TC
  954.     AVATAR / LD
  955.     Zodiak / Cascada
  956.     SiPiYou / VD
  957.     Zomb
  958.     Ratzkartoffel for nice hints!
  959.     Christophe Yvon
  960.     Moku / Assembly Organizing
  961.  
  962.     Chaos, Pole & Garlick
  963.     Michael Erdmann
  964.     David "that cool spanish guy that writes loong and booring letters"
  965.       Márquez Hernández :)
  966.  
  967.         and all those guys that wrote one or more letters to me...
  968.          (Just no time to reply... Berthold Meyer has delayed the release for
  969.           at least a day, and now I don't have the time to send you the
  970.           latest release before I leave... FEEEEERIEN!!!!)
  971.         you'll get a reply... but later.
  972.  
  973.  
  974.  
  975.   6.1: Adresses
  976.   --------------
  977.  
  978.     SNAILMAIL:
  979.       Niklas Beisert  (pascal)
  980.       Oberstraße 84
  981.       20149 Hamburg
  982.       Germany
  983.  
  984.     INTERNET:
  985.       bertolt.meyer@hamburg.netsurf.de
  986.  
  987.     FiDO-NET:
  988.       Niklas Beisert@2:240/5121
  989.  
  990.     SUPPORT BBS:
  991.    +---------------------------------------+
  992.    |     MEDIA BBS,  5.2 GB online         |
  993.    |                                       |
  994.    |   +49-40-677 95 53 [16.8 ZyXEL]       |
  995.    |      FIDO: 2:240/5121                 |
  996.    |      SFX: 747:49/4002                 |
  997.    |      WOS: 46:4920/110                 |
  998.    |      OA-NET: 123:4003/23              |
  999.    |   +49-40-675 38 78 [28.8 V.Fast]      |
  1000.    |      FIDO: 2:240/5122                 |
  1001.    |      SFX: 747:49/4001                 |
  1002.    |                                       |
  1003.    | with a special menu for cubic player  |
  1004.    +---------------------------------------+
  1005.  
  1006.  
  1007.  
  1008.        Have fun with CUBIC-Player...
  1009.  
  1010.  
  1011.                 pascal / doj / ?hook
  1012.  
  1013. PS: please vote for VEX-Intro on the Assembly '94 CD-ROM Voting Card (64k)
  1014.